home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 016a / fixcntrl.zip / FIXCNTRL.DOC next >
Text File  |  1993-05-26  |  5KB  |  97 lines
  1.  
  2. FIXCNTRL.EXE - cuts unwanted conferences from QWK control.dat files
  3. ===================================================================
  4.  
  5. syntax: fixcntrl [n]  where n - 1 is an [optional] highest numbered
  6.                       conference to leave in the file.  Default is 999.
  7.  
  8. purpose:  Some older QWK readers were set up to handle only a limited
  9.           number of conferences.  For example, PowerQWK (PQ 2.15) uses
  10.           pseudo-conference #1000 as its storage area for the user's
  11.           personal messages.  When Channel One BBS in Cambridge, MA
  12.           added conference slots for a few hundred "rsrvd" conferences
  13.           in early 1993 it overran PQ's limits, and message traffic in
  14.           the CH1 Main Board indicated some other readers may have been
  15.           affected as well. 
  16.           
  17.           The file "control.dat" in the QWK packet contains a list of
  18.           all the active conferences on the BBS.  If you are using the
  19.           QMAIL door, it can be instructed to send only the conferences
  20.           which you have selected in control.dat - but this is a poor
  21.           solution, as you can't use offline processing to join a new
  22.           conference if your reader doesn't know it exists, and you
  23.           may prefer the facilities in Cam-mail or another door.
  24.           Fixcntrl.exe will remove conferences above #999 (or another
  25.           number you specify) from the control.dat file, making it
  26.           palatable to older QWK readers like PQ.  Of course, the
  27.           inevitable tradeoff is that your reader cannot access these
  28.           removed conferences.
  29.           
  30.           I wrote fixcntrl.exe specifically to make PQ 2.15 work with
  31.           Channel One, but it may also be useful with other QWK readers
  32.           or on other BBSs.  It is intended to be run from a batch file.
  33.           The control.dat file must be extracted from the QWK file and
  34.           available in the current working directory when fixcntrl is run,
  35.           although fixcntrl itself can be anywhere on the path.  If
  36.           fixcntrl fails for any reason (can't find control.dat, disk
  37.           full, etc.) it returns errorlevel 1, which can be tested in
  38.           your batch file.  Here is an excerpt from mine:
  39.  
  40. ========
  41.  
  42. :channel1
  43. md mtemp
  44. cd mtemp
  45. copy c:\data\zc\channel1.qwk .
  46. lha e channel1.qwk control.dat
  47. fixcntrl
  48. if errorlevel 1 goto uhoh
  49. lha u -m channel1.qwk control.dat
  50. copy channel1.qwk c:\data\zc\mail\in\channel1.qwk
  51. copy channel1.qwk c:\data\zc\doncha.qwk
  52. del c:\data\zc\channel1.qwk
  53. del /y *.*
  54. cd ..
  55. rd mtemp
  56. return
  57.  
  58. :uhoh
  59. {...error processing...}
  60.  
  61. ========
  62.  
  63.           By default, fixcntrl.exe will remove all conferences numbered
  64.           999 or above from the control.dat file.  You can optionally
  65.           specify a highest numbered conference to retain, which should
  66.           be one higher than the highest conference number you need (to
  67.           take the Main Board, conference #0, into account). For example,
  68.           "fixcntrl 7" would retain the Main Board (conf #0) and confs
  69.           1 through 6 (for a total of 7), and discard all the others.
  70.           If you specify a number higher than the number of conferences
  71.           on the BBS control.dat will remain unchanged, and most silly
  72.           entries (fixcntrl -33 or fixcntrl 100000) should revert to the
  73.           default, although I'll bet you can break this if you try hard
  74.           enough.  Your original control.dat file will be irreversibly
  75.           overwritten by fixcntrl.exe - so you should probably experiment
  76.           on a copy of control.dat from an old QWK file to assure yourself
  77.           that all is well.  (Control.dat is a plain ASCII file that you
  78.           can read with LIST or any ASCII editor.  Line #11 is the number
  79.           of conferences, minus one.  Try "fixcntrl 4" on a spare copy
  80.           of control.dat to see how it works.  You should end up with 3
  81.           on line #11, and conferences 0-3 listed after).  Fixcntrl.exe
  82.           retains all the optional user statistics information (time
  83.           used, # of downloads, etc.) which is appended to control.dat by
  84.           Cam-Mail and other mail doors, so it is available for your
  85.           reader to display if it has this function.
  86.  
  87. warranty: None.  I wrote fixcntrl.exe for myself, and it works for me.
  88.           You are free to use it if you'd like to, with no obligation
  89.           whatsoever and entirely at your own risk.  If you run into
  90.           trouble with fixcntrl.exe, you may leave a message on the Main
  91.           Board at Channel One (617-354-8873) and I'll see if I can help
  92.           you out, but as far as "support" goes, that's it.  Have fun!
  93.  
  94.                                                       Ken Haverly
  95.                                                       May 26, 1993
  96.  
  97.